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Section 1 


INTRODUCTION 


1.1 PURPOSE 

CROSSREF is a tool to assist a user in obtaining information 
about the contents of a library which was generated with a 
BUILD statement on the CRAY Computer under the CRAY OPERATING 
SYSTEM (COS) . It develops several alphabetized listings and 
tables which yield information about each member of a 
library. It also produces statistics about the library. 


1.2 FEAIl?fiSS 

CROSSREF produces the following: 


1. List of all modules contained within a library. 

2. Summary table by modules containing module size, 
module ENTRY POINTS, referenced COMMONS and required 
EXTERNALS . 

3. List Of all ENTRY POINTS. 

4. List of UNSATISFIED EXTERNALS. 

5. Summary table of ENTRY POINTS and optionally 
EXTERNALS . 

6. List Of COMMONS. 

7. Summary table of COMMONS. 

8. Table of Statistics 

9. Table of Contents 

10. Optionally allows output to be formatted to 8 1/2 

inch vertical printer paper or CRT display. 
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Section 2 


INPUT AND OUTPUT 


2.1 INPUT DATA STRUCTURE 

The input data is the last record of a library file which was 
generated by COS when the library was generated with a BUILD 
statement in the CRAY'S JCL. The user has no control over 
this last record but will ACCESS it as shown in the Usage 
section of this document. For more information regarding this 
record see CRAY document COS Table Description (Internal 
Reference Manual SM-0045 under the loader directory table 
"DFT") . 


2 . 2 OUTPUT FILE STRUCTURE 


Printed lists and tables are the only forms of output from 
this program. It requires an output device which is capable 
of 132 print positions unless the option for a CRT is used. 


t 
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Section 3 


LIMITATIONS AND TIMING 
3.1 LIMITATIONS. OF -TABLES 


CROSSREF has the following limitations of Its internal tables: 

Maximum or 4096 modules per library. 

Maximum of 4096 ENTRY POINTS and/or EXTERNALS per 
library. 

Maximum of 4096 commons per library. 

Maximum of 1024 ENTRY POINTS and/or EXTERNALS per module. 
Maximum of 1024 COMMONS per module. 


3.2 TIMING CONSIDERATIONS 

No absolute benchmarks for timing of CROSSREF have been 
established. However, using the CRAY default of eight 
seconds should under normal conditions, be more than 
adequate for most libraries. 
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Section 4 


IZSASS 


4.1 OPTIONS 

CROSSREF normally defaults to format its output on eleven (11) 
inch vertical paper of sixty one (61) lines and 132 characters 
vide. Also, it defaults to exclude CRAY systems EXTERNALS in 
its lists and summaries (i.e., modules with special characters 
in the name) . 

The above defaults can be overridden by setting sense 
switches . They are : 

SWITCH 1 ON to include CRAY systems EXTERNALS. 

SWITCH 2 ON to format the output for eight and one half 
(8 1/2) inch vertical paper of fifty one (51) lines and 
132 

characters wide. 


SWITCH 3 ON to format the output to a CRT. (80 
characters wide by 24 lines vertical) . 


4.2 EXAMPLES OF JOB CONTROL IANGUAGE 
In the following examples: 

eod - Cards use 7/8/9 in column one. 

Mercury or Jupiter VAX use /EOF. 

VAX's except Jupiter or Mercury use %%E0R. 

eoi - Cards use 6/7/S/9 in column one. 

Mercury or Jupiter VAX use /EOF. 

VAX's except Jupiter Mercury U3e %%EOF. 
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Example A: 

To lint Information contained within a library and 
accepting CROSSREF's defaults. 

JOB , JN— j obname , US-user , PW-password . 

ACCOUNT, AC-user account. 

ACCESS , DN-XREF , PDN-CROSSREF , ID-SOFTLIB . 

ACCESS , DN-LIBN , PDN-name of library, ID-user id. 

SKIPD, DN-LIBN. 

SKIPF , DN-LIBN , NF— 1 . 

COPYF , I-LIBN , 0-TAPE1 . 

REWIND, DN-TAPE1 . 

ASSIGN , DN-TAPE1 , A- FT 01 . 

LDR, DN-XREF. 

eod 

eoi 

Example B: 

To list information contained within a library fromatted 
for 8 1/2 inch vertical output and with systems 
EXTERNALS . 

JOB , JN-j obname , US-user , PW«password . 

ACCOUNT, AC-user account. 

ACCESS , DN-XREF , PDN-CROSSREF , ID-SOFTLIB . 

SWITCH, 1-0N. 

SWITCH, 2-ON. 

ACCESS r DN«LIBN,PDN«name of library, ID-user id. 

SKIPD , DN-LIBN . 

SKIPF , DN-LIBN , NF— 1 . 

COPYF , I-LIBN , O-TAPEl . 

REWIND, DN-TAf El. 

ASSIGN , DN-TAPE1 , A-FT01 . 

LDR, DN-XREF. 

eod 

eoi 
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Section 5 


ERROR MESSAGES 

All error massages appear in the CRAY systems logfile. When 
an error Is encountered, the job aborts. 


ERROR WRONG TYPE INPUT 


Will be displayed when a library file was not ACCESSed, 
positioned with SKIPF, SKIPD and COPYF- or ASSIGNed 
correctly. See the JCL section. 


All other error messages are of the form: 


XXX 

TABLE OVERFLOW 

Whe^e XXX is the table which exceeded the limits stated 
in the Limitation section. 
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i . A 

SAMPLE PRINTOUT * -D FOR 11 1/-" paper 

Printout from CROSSREF when set up for eleven inch 
printer stock and set up to include systems routines. 
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APPENDIX B 


SAMPLE PRINTOUT FORMATTED FOR CRT DISPLAY CROSSREF 


Setup to format for a CRT and set up to include systems 
routines . 
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APPENDIX C 


Logfile of CROSSREF when set up to include systems 
routine and to format output to a CRT display. 
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6. Mkrtormicn OrfMiiuition M»port Mo. 

TN 84-7104-101-12 

10. Work Omt No 

• eerlorrmnf OTenuetton Nene erS AdSrei* 


K1707 

Informatics General Corporation 
1121 San Antonio Road 

11. Ce ''ot or Grom No 

NAS2-11555 

Palo Alto. CA 94303 


13. Typo at Hopm aid iNrioa Cov»«1 

12 Seontoring Ag*ncy fctom# 

Space Aam Lnir tration 

Contractor Report 

National Aeronautics and 
Washington, D.C. 20546 

• 1# Sooniorinf Afoncy Codt 

j 999-53-02 

15 SuPCFememw Motet 

Robert A. Carlson (413) 694-6036 

Point of Contact: FTS 448 -6036 

Moffett Field. CA 94035 

1 6 A betruct 

Crossref for the Cray is a tool used to obtain inf ormation about the contents 
of a library generated with a BUILD statement under COS. It produces a list 
cf all modules in the Library; a summary table by modules containing module 
size, ENTRY POINTS, referenced COMMONS, and required EXTERNALS; a list of 
unsatisfied EXTERNALS; a summary table of ENTRY POINTS and optionally 
EXTERNALS; a list of COMMONs; a table of statistics and a table ot contents. 
The output can be formatted to 8 1/2 inch vertical paper or r RT display. 









‘7 k#y (Su^gwtad Dv Author (in 

Alphabetized library listing, Cray 

cross reference, software tool 

18 Dtftnbution Statement 

Unclassified, unlimited 
Star Category - 61 


19 Security Oonif (o< tfwt rsportl 

Unclassif iea 

• J 

20 Security Ooaif to f itur ptpt' 

Unclassif ied 

21 Me of Migyr 
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